home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / keymap00.zip / KEYMAP.DOC < prev    next >
Text File  |  1991-10-12  |  3KB  |  69 lines
  1.         KEYMAP.SYS v0.0 - A Keyboard Key Mapper
  2.  
  3. KEYMAP.SYS allows you to change the layout of your keyboard.  Your changes
  4. may be as simple as the swapping of the Ctrl and Caps Lock keys, or you can
  5. set up a completely new layout (like the Dvorak layout).  You may create up
  6. to ten layouts, and switch among them at will.
  7.  
  8. As provided, the software defines two layouts.  The default is the Sholes
  9. layout, also known as the QWERTY layout.  This is a standard layout, with
  10. no keys moved.  The second provided layout is the Dvorak layout.
  11.  
  12.          SHOLES                 DVORAK
  13.  
  14.     1 2 3 4 5 6 7 8 9 0 - =        1 2 3 4 5 6 7 8 9 0 = [
  15.      Q W E R T Y U I O P [ ]     ' , . P Y F G C R L / ]
  16.       A S D F G H J K L ; '          A O E U I D H T N S -
  17.        Z X C V B N M , . /           ; Q J K X B M W V Z
  18.  
  19. To switch between layouts, hold down the Control, Alt, and Left Shift keys,
  20. then press a function key.  F1 selects the default layout (Sholes).  As
  21. provided, F2 selects the Dvorak layout.  You can install up to ten different
  22. layouts, enabled by F1 through F10.
  23.  
  24. To install a new layout, you will need a text editor and an assembler.  The
  25. software is written for use with Borland's Turbo Assembler.  To assemble it
  26. with a different assembler, you will probably have to edit the source code.
  27.  
  28. The first step in creating a new layout is to write the keyboard definition
  29. file.  Two sample files are provided, SHOLES.KBD and DVORAK.KBD.  To make
  30. minor changes to the keyboard layout, use one of these files as a starting
  31. point.  To swap two keys, simply find the two lines containing those keys,
  32. and swap them.  The file defines a mapping between the physical scan codes
  33. produced by the keyboard, and virtual scan codes.  For each physical scan
  34. code (that is, for each line in the file), you provide the scan code for
  35. the key you want your programs to see.  For instance, the Dvorak layout
  36. replaces the Q key with the Apostrophe.  So, on the line in DVORAK.KBD
  37. which represents the physical Q key's scan code, the scan code for the
  38. Apostrophe key is provided.
  39.  
  40. After you create the definition files for all the layouts you would like
  41. to use, you have to edit KEYMAP.ASM to insert your layouts into the program.
  42. At the label "maptab", place up to ten include directives to add the layouts
  43. you want.  Each layout will be assigned, in order, to the function keys
  44. F1 through F10.  The first layout will be the default, enabled at startup.
  45. Once that is done, you can assemble and link the program.  A Makefile has
  46. been provided, which you can use directly if you have MAKE.  Otherwise you
  47. can read it to see what options I use when assembling.
  48.  
  49. This software works by hooking INT 15h, function 4Fh.  This function is
  50. provided to allow keys to be remapped, but may not be present on machines
  51. with very old BIOS ROMs.  Some software packages (notably games) take over
  52. the keyboard interrupt, disabling KEYMAP.SYS.  While using such software,
  53. the keyboard will return to its standard layout.
  54.  
  55.  
  56. Syntax:
  57.  
  58.     DEVICE=[d:][path]KEYMAP.SYS
  59.  
  60.     d:    specifies the drive where KEYMAP.SYS is to be found.
  61.     path    specifies the directory where KEYMAP.SYS is to be found.
  62.  
  63.  
  64. Examples:
  65.  
  66.     DEVICE=C:\SYS\KEYMAP.SYS
  67.  
  68.         Load KEYMAP.SYS from the SYS directory on drive C.
  69.